---
title: PdfAPI.Core API reference
summary: Index of all public types in this library.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-17
library: PdfAPI.Core
reference_type: package
---

# PdfAPI.Core API reference

This page lists all public types exposed by `PdfAPI.Core`. Each type links to its full API reference page. Types are grouped by namespace; `PdfAPI.Core.v1` and `PdfAPI.Services.PdfSettings` are excluded because they are not part of the compiled assembly (see [Architecture](../architecture.md)).

## Types

### PdfAPI.Core

| Type | Kind | Namespace | Purpose |
| --- | --- | --- | --- |
| [Document](PdfAPI.Core/Document.md) | Class | `PdfAPI.Core` | In-memory and on-disk representation of a single file participating in a PDF operation. |
| [DocumentRange](PdfAPI.Core/DocumentRange.md) | Class | `PdfAPI.Core` | Pairs one document with the page ranges selected from it. |
| [DocumentRangeFactory](PdfAPI.Core/DocumentRangeFactory.md) | Class | `PdfAPI.Core` | Convenience construction of `DocumentRange` from bytes, a file path, or an existing document. |
| [IPageRange](PdfAPI.Core/IPageRange.md) | Interface | `PdfAPI.Core` | Read contract for a page selection. |
| [PageRange](PdfAPI.Core/PageRange.md) | Class | `PdfAPI.Core` | Immutable page selection, including parsing of page-expression syntax. |
| [PdfRequest](PdfAPI.Core/PdfRequest.md) | Class | `PdfAPI.Core` | Base request contract for all PDF operations. |
| [ConvertRequest](PdfAPI.Core/ConvertRequest.md) | Class | `PdfAPI.Core` | Single-document conversion request. |
| [MergeRequest](PdfAPI.Core/MergeRequest.md) | Class | `PdfAPI.Core` | Multi-document merge request. |
| [ExtractPagesRequest](PdfAPI.Core/ExtractPagesRequest.md) | Class | `PdfAPI.Core` | Page-extraction request. |
| [PdfOptions](PdfAPI.Core/PdfOptions.md) | Class | `PdfAPI.Core` | Per-request output and cleanup options. |
| [PdfResult](PdfAPI.Core/PdfResult.md) | Class | `PdfAPI.Core` | Result contract returned by every operation. |
| [PdfTrackingInfo](PdfAPI.Core/PdfTrackingInfo.md) | Class | `PdfAPI.Core` | Immutable tracking snapshot for a document. |
| [PdfTrackingMetadata](PdfAPI.Core/PdfTrackingMetadata.md) | Class | `PdfAPI.Core` | Encodes and decodes the file-name prefix convention carrying tracking metadata. |
| [PdfException](PdfAPI.Core/PdfException.md) | Class | `PdfAPI.Core` | Domain exception for invalid PDF input and load failures. |
| [PdfClientService](PdfAPI.Core/PdfClientService.md) | Class | `PdfAPI.Core` | Static, stateless iTextSharp-backed facade for PDF inspection, transformation, and validation. |
| [Extensions](PdfAPI.Core/Extensions.md) | Class | `PdfAPI.Core` | Display-formatting extension method for `PdfFormat`. |
| [DocumentTypes](PdfAPI.Core/DocumentTypes.md) | Enum | `PdfAPI.Core` | Distinguishes input from output documents. |
| [PdfConversionType](PdfAPI.Core/PdfConversionType.md) | Enum | `PdfAPI.Core` | The kind of PDF operation a request represents. |
| [PdfFormat](PdfAPI.Core/PdfFormat.md) | Enum | `PdfAPI.Core` | Output document format. |
| [PdfProcessorType](PdfAPI.Core/PdfProcessorType.md) | Enum | `PdfAPI.Core` | The processing engine that produced or should produce a result. |
| [PdfStatus](PdfAPI.Core/PdfStatus.md) | Enum | `PdfAPI.Core` | Lifecycle status of a tracked PDF operation. |

### PdfAPI.Core.Cache

| Type | Kind | Namespace | Purpose |
| --- | --- | --- | --- |
| [CacheType](PdfAPI.Core.Cache/CacheType.md) | Enum | `PdfAPI.Core.Cache` | Selects which cache store a request targets. |
| [PdfCacheRequest](PdfAPI.Core.Cache/PdfCacheRequest.md) | Class | `PdfAPI.Core.Cache` | Request to read a cached PDF by source id. |
| [PdfCacheCreationRequest](PdfAPI.Core.Cache/PdfCacheCreationRequest.md) | Class | `PdfAPI.Core.Cache` | Request to write a PDF into the cache. |
| [PdfCacheResult](PdfAPI.Core.Cache/PdfCacheResult.md) | Class | `PdfAPI.Core.Cache` | Cache lookup or creation outcome. |

### PdfAPI.Core.Convert

| Type | Kind | Namespace | Purpose |
| --- | --- | --- | --- |
| [SourceConversionType](PdfAPI.Core.Convert/SourceConversionType.md) | Enum | `PdfAPI.Core.Convert` | The originating source format behind a conversion. |

## Sources
- `PdfAPI.Core\PdfAPI.Core.csproj`